home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro135 / showgif.doc < prev    next >
Encoding:
Text File  |  1989-12-20  |  11.2 KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                Documentation for:
  21.  
  22.  
  23.                                   SHOWGIF  4.1
  24.  
  25.  
  26.  
  27.  
  28.                                        by
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                  Bill  Parquet
  36.  
  37.  
  38.                                       and
  39.  
  40.  
  41.                                  Dave Sharpless
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                  Copyright 1989
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                   Introduction
  74.  
  75.               How many times have you downloaded a GIF file from your
  76.          favorite BBS only to discover you wasted maybe 15 minutes and
  77.          50,000 bytes of download credits on an array of dots that
  78.          doesn't deserve to be called a picture, or had a "bad code in
  79.          file" after the first 10 lines?  Wouldn't it be nice to be
  80.          able to see the picture as you are getting it, and if you
  81.          don't like it, just abort the transfer, saving your time and
  82.          credits for something more worthwhile?  If so, SHOWGIF is
  83.          just the program for you!  It is a TSR which sits in memory,
  84.          quietly waiting for the system to begin writing a GIF file.
  85.          Once the write begins,  SHOWGIF switches to the appropriate
  86.          VGA video mode, and shows the picture as it is coming over.
  87.          It is compatible with most download protocols available.
  88.  
  89.  
  90.                               System Requirements
  91.  
  92.               SHOWGIF makes several requirements on your video
  93.          hardware.  For SHOWGIF to function properly, your system must
  94.          be equipped with EGA or higher.  SHOWGIF also requires about
  95.          64k of memory.
  96.  
  97.  
  98.  
  99.                              Operation Instructions
  100.  
  101.               SHOWGIF should be installed sometime before you load
  102.          your terminal program.  This installation can be performed
  103.          simply by typing "SHOWGIF" just before loading your terminal
  104.          program, or inserting "SHOWGIF" in the batch file for your
  105.          terminal.  "SHOWGIF" will remain quiet in memory until a file
  106.          with the extension ".GIF" is created on your disk.  "SHOWGIF"
  107.          will go into high resolution mode as soon as it gets enough
  108.          information.  (usually after the second Ymodem block)  From
  109.          that point, data will be put up on the screen just before it
  110.          goes to disk.  If you want to abort this viewing process,
  111.          press the backspace key ("<-").   Note that this will abort
  112.          the file viewing process, not the download itself.   Aborting
  113.          the download (With ESC, ^C, ^X, or likewise) will also abort
  114.          the viewing, and bring up the "Incomplete picture" message.
  115.          Similarly, if the picture data is garbled, a "Bad code in
  116.          picture" will appear, aborting the viewing, but not the
  117.          download itself.  Once you are done downloading and have left
  118.          your terminal program, type SHOWGIF /u  (note the 'u' is
  119.          lowercase).  This will remove SHOWGIF from your computer,
  120.          returning all of about 64k.
  121.  
  122.          NOTE:  Since SHOWGIF is activated on the creation of a GIF
  123.          file on your disk,  COPYing a GIF file around will also kick
  124.          in the viewer.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                       Hints and Tips on the use of SHOWGIF
  140.  
  141.  
  142.               SHOWGIF can be put in your AUTOEXEC.BAT, but it isn't
  143.          recommended.  If you have not done so already, create a batch
  144.          file which installs SHOWGIF, runs your favorite terminal
  145.          program and then uninstalls SHOWGIF.  This method is better
  146.          for two reasons,  one (1) because SHOWGIF is not constantly
  147.          taking up memory when it is not needed, and two (2) because
  148.          you don't risk installing something on top of SHOWGIF, which
  149.          could lock up the computer on SHOWGIF's removal.
  150.  
  151.  
  152.                               Configuring SHOWGIF
  153.  
  154.               SHOWGIF is designed to handle a variety of forms video
  155.          hardware.  To set up SHOWGIF, a program called "CSHOWGIF" has
  156.          been provided.  It will set up SHOWGIF for EGA, VGA, Orchid
  157.          ProDesigner Plus, ATI VGA wonder, Paradise (256 and 512),
  158.          Everex, Genoa 5200/STA VGA-EM, Tecmar 256 and VGA-AD, Video7
  159.          V7 VRAM, Video7 Fastwrite, and Video7 Fastwrite AD/VRAM.  On
  160.          running CSHOWGIF, the current configuration of SHOWGIF will
  161.          be displayed, and you will be asked if you want change this.
  162.          Unless you are operating an EGA card, select "Y" for yes.
  163.          You will be prompted with the various types of VGA cards
  164.          which SHOWGIF supports.  Pick your card out of this list and
  165.          press return.  SHOWGIF will be rewritten, configured for your
  166.          particular video card.
  167.  
  168.  
  169.  
  170.                     Which Protocols Work Best With ShowGIF?
  171.  
  172.  
  173.               It will take some experimentation to determine exactly
  174.          which protocols jive well with ShowGIF, but we can give you a
  175.          few suggestions on what to use and what not to use.  Zmodem
  176.          (DSZ) by Omen Technologies has been found to work excellently
  177.          with ShowGIF at speeds up to 19200 baud.  Other protocols,
  178.          such as Qmodem 4.0/4.1 (-r- the Forbidden Project) internal
  179.          Ymodem Batch which write to disk before sending their ACK
  180.          code will be hurt the most (as ShowGIF dramatically increases
  181.          drive access time) and are not recommended.  Protocols such
  182.          as SeaLink (CLINK 1.20) by System Enhancement Associates
  183.          which create a temporary file then rename are least
  184.          recommended because they will never activate ShowGIF.  You
  185.          should not notice any significant drop in CPS in protocols
  186.          which work well with ShowGIF.  External modem users should
  187.          not notice any lengthy propagations between blocks (the RD
  188.          light staying off for more than second and half or more)
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                Update Information
  206.  
  207.  
  208.          1.0 α: First version of SHOWGIF <Not released>
  209.  
  210.          1.0 ß: Several features added:  <Not released>
  211.  
  212.               * Status report at the end of viewing (Not a gif, bad
  213.                      code, etc.)
  214.               * Support for ATI, separate versions of the program
  215.               * Switch back normal video if d/l is aborted before
  216.                      viewer is aborted.
  217.               * Squeezing pictures to fit 320x200 (MCGA version)
  218.  
  219.          2.0  : Several problems fixed: <Beta Test>
  220.  
  221.               * Code parsing routine completely re-written for speed
  222.               * Rest of the main loop translated into machine language
  223.               * Lockup after "Picture is not a GIF" message resolved
  224.               * Picture information put up while drawing
  225.               * Stack frame is normalized after each picture -- no
  226.                      more lockup's after viewing 'too many' pictures
  227.               * 500% overall increase in speed! (benchmark 20 seconds
  228.                    in 1.0 to 4 seconds in 2.0)
  229.  
  230.  
  231.          3.0  : Improvements made <Beta Test>
  232.  
  233.               * Support for EGA
  234.               * X axis scaling for pictures larger than 320 MCGA,EGA
  235.  
  236.          3.5  : Improvements made <First release>
  237.  
  238.               * One program can handle various video cards
  239.               * Internal configuration for video hardware
  240.               * Support for 10 more video cards
  241.  
  242.          3.7  : Improvements made <Beta Test>
  243.  
  244.               * 16 color (EGA) modes supported in standard VGA
  245.                    configuration (640x350 and 640x480)
  246.               * Offset picture difficulties corrected.
  247.  
  248.          4.1  : Improvements made <Second release>
  249.  
  250.               * User definable resolutions (compatible with VPIC)
  251.               * Better judgement is used when choosing video modes.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                 Shareware notice
  272.  
  273.  
  274.               Like most authors of Shareware, we do not seriously
  275.          believe that you are going to send money.  Likewise, we
  276.          assume that you are not going send us complaints about the
  277.          fact that it does not support that Super-VGA card you bought
  278.          at BIG and small lots, which came with a complimentary banana
  279.          slicer/dicer/peeler/seed remover.  If you have any comments,
  280.          leave them to Bill Parquet on one of the boards listed in the
  281.          intro, The Henrietta Outhouse (216/965-5463), or N.O.I.S.E.
  282.          BBS (419/473-8651 -- FidoNet 234/17) Enjoy!
  283.  
  284.  
  285.                                      Errata
  286.  
  287.               In further testing, it was proven that ShowGIF does not
  288.          significantly affect the total transfer thoroughput in the
  289.          Qmodem internal protocols.  That doesn't mean there aren't a
  290.          few dificulties with Qmodem.  The odd file opening convention
  291.          which is used just after initiating the download will cause
  292.          ShowGIF to temporary activate then quit with a "GIF
  293.          incomplete message" then re-activate, after which everything
  294.          will function perfectly.  It looks as if something is
  295.          radically wrong, but don't worry about it.
  296.  
  297.  
  298.                         Notes on the Configuration Files
  299.  
  300.  
  301.               If you have ever seen the video card configurations for
  302.          VPIC**, these should look fairly familiar.  The top line of
  303.          the file is the name of the card being defined.  You name the
  304.          card anything you wish.  This particular parameter is just
  305.          for future identification.  The line contains the plane
  306.          switching methodology*.  If in doubt, just leave it alone.
  307.          The next two lines are not used by ShowGIF and are included
  308.          just for compatibility.  The subsequent lines define all of
  309.          the pertinent video modes for your card.  It consists of
  310.          several numbers which are defined as follows:  1) Mode type
  311.          (0 for EGA, 1 for VGA - this is related to the number of
  312.          colors available) 2) Palette definition (0 for EGA, 1 for
  313.          VGA.  VGA Palette definition is considerably more precise.
  314.          Use EGA palette definition only if you are operating an EGA
  315.          card!)  3-6) The values for AX,BX,CX,DX required to switch
  316.          the card into that particular mode (for instance VGA 320x200
  317.          would be 0x13 0 0 0) 7) X resolution 8) Y resolution 9)
  318.          Number of colors available in this resolution.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.          *Not all of the plane switching techniques are supported.
  338.          Those cards which use TRIDENT and CIRRUS will generate the
  339.          Unidentified plane switching technique warning and default to
  340.          NONE.  Either leave us some mail on how to do it or stick
  341.          with Plain Vanilla.  (NONE, TSENG, ATI, VIDEO7, PARADISE, and
  342.          EVEREX   ARE supported).
  343.  
  344.          **VPIC is a first rate picture file viewer.  2.2 is the
  345.          newest version at the time of this writing.  VPIC may
  346.          be obtained from
  347.               BOB MONTGOMERY
  348.               132 PARSONS RD
  349.               LONGWOOD FL 32779
  350.          for the price of about $15 for registration (I think).
  351.  
  352.  
  353.                           Thank you for using ShowGIF!
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.